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SPECIFICATIONS FOR NETWORK USE OF 


THE UCSB ON-LINE SYSTEM 


INTRODUCTION 


UCSB's On-Line System (OLS) is available to 
Network users as socket number x'101*' at site 3. 
Network users should log in with the following OLS 
accounting parameters: 


USER NUMBER= 196 

ID NUMBER= 57372 

USER NAME= site name--UCLA,SRI,UTAH,BBN,MIT, 
SDC,RAND--whichever is appropriate. 


Users communicate with OLS through an intermediary process, 
hereafter called the Interface, which is addressed as 
socket number x'101' (which is termed OLS's "primary 
socket"), and can be invoked through the Logger. This 
document is intended to provide programmers with the infor- 
mation necessary to communicate with the Interface; and to 
define the input expected and the output returned. The 
reader is assumed familiar with the Culler-Fried system at 
UCSB from a user's standpoint. Specifically, this document 
is not a user's manual for OLS. 

The Interface conducts all Network transactions 
through the NCP, which operates under the Host-Host protocol 
of 3 August 70. The first message sent by the Interface is 
of Type 0: the first eight bits are zeros and thereafter, 
for the life of the connection, Imp-message boundaries are 
not significant. Similarly, the Interface expects the first 
message it receives to be Type 0, discards the first eight 
bits assuming them to be zeros, and thereafter for the life 
of the connection takes no notice of Imp-message boundaries. 

A word about terminology. The 360/75 is a 32-bit 


machine, but its instruction set is byte-oriented. A byte 
is eight bits, and those eights bits are numbered 0-7 from 
left to right. Terms such as "listen", "request connection", 


“accept a connection", and "reject a connection" are used 
freely herein to describe those primitive Network functions 
which a user at a foreign site presumably has available to 
him through his NCP. They are used here in the same senses 

in which they have frequently been used in the NWG literature. 


LOGGING INTO THE INTERFACE 


To use the On-Line system, the Network user must 
establish a full-duplex connection with the Interface. 
The Interface is core resident only while at least one 
such duplex connection is established (i.e. while at least 
one Network user is connected). At all others times, the 
Interface resides on direct-access storage and must be 
invoked through the Logger. A login sequence can always 
be initiated by requesting connection to OLS's primary socket. 
While in core, the Interface listens on that socket and will 
accept any call it receives; at all others times, the Logger 
listens on that socket and will reject the first call it 
receives, read the Interface into core, and dispatch it. 
The Interface will then listen on the primary socket as 
before. Thus to initiate a login sequence, the user requests 
connection to the primary socket. If accepted, he is in 
contact with the Interface. If rejected, he should re- 
issue the connection request; when accepted, he will be 
connected to the Interface. A second rejection would 
indicate that the On-Line System was inactive, or that 
either the Interface or the NCP had exhausted its resources. 
Over this initial connection, the Interface will send 
eight bits of zeros, indicating message type zero, followed 
by a 32-bit socket number which it will select from a pool 
of socket numbers allocated to it, It will then promptly 
close the connection and re-issue the listen, to allow 
other users to begin login. It will then request con- 
nection of the local socket whose number was sent to the 
user, with the foreign socket whose number is one greater 


than that of the user's socket. Similarly, it will request 
connection of the local socket whose number is one greater 
than that sent to the user, with the user's socket. Once 


these two connections have been established, the Interface 
will consider the user logged in. 

The two connections thus established are maintained 
indefinitely by the Interface. Over its receive connection 
(hereafter termed the "Input Connection"), the Interface 
accepts input for OLS. Over its send connection (the 
"Output Connection"), the Interface relays displays from 
OLS generated in response to the input. The Interface will 
terminate these connections only should the On-Line System 
terminate. The user is expected to close the two connections 
when finished, making the local sockets available for 
reallocation, at which time the Interface will consider the 
user logged off. 


THE INPUT CONNECTION 


With the exception of the first two bytes, data 
received by the Interface over the Input Connection is 
treated as a continuous stream of one-byte key codes, 
potentially endless in extent. The Interface passes each 
key code--unexamined--to the On-Line System, which in turn 
processes it exactly as it would input from a key-board 
connected directly to the System. The set of valid key 
codes and its relation to the standard OLS key-board are 
depicted in Figure 1. The Interface makes no validity 
check of the incoming data, but OLS will detect and dis- 
card invalid key codes. , 

Normally, the first keys sent over the Input Connection 
(i.e. the first keys that the Network user pushes) should 


be those necessary to log in to OLS. The user may log in 
and out many times during the life of the Network connection, 
and these operations are transparent to the Interface. The 


last keys sent over the Input Connection should log the 
user off of OLS (SYST DOWN). Failing to log off before 
terminating the Network connection allows the possibility 
of a later Network user's finding himself already logged in. 
The first byte of data received over the Input 
Connection is discarded unexamined by the Interface, which 
assumes it to be zeros indicating message type zero in 
compliance with Host-Host protocol. No significance is 
attached to Imp-message boundaries. The second byte of 
data received is not passed to OLS but is examined by the 
Interface. By appropriately Selecting that second byte, 
the user can cause to be suppressed by the Interface, any 
or all of the three classes of output generated by OLS and 
potentially relayable to the user over the Output Connection. 
The byte is interpreted as follows: 


Bit 0 = 41: suppress all alphameric output. 

Bit 1 = 1l: suppress all curvilinear output. 

Bit 2 = ]: “suppress all special character output, 
Bits 3-7: not examined, should be zeros, 


Once made, this declaration prevails for the life of the 
Network connections. A user can avoid transmission of 
output classes he is unable to process and would therefore 
have to discard anyway, thus avoiding neediess Network traffic. 
A user operating from a teletype and capable of displaying 
only alphameric output, for example, might specify x'60' 
and thereby suppress all else. 
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Figure 1. y INPUT KEY CODE SET 


THE OUTPUT CONNECTION 


With the exception of the first byte, data transmitted 
over the Output Connection by the Interface consists of a 
continuous string of variable-length records. The first 
byte sent consists of zeros, indicating message type zero, 
to comply with Host-Host protocol, and should be discarded 


by the user. At present there are three classes of records 
defined, one corresponding to each class of OLS output-- 
alphameric, curvilinear, and special characters. Only 


records of those classes which have been enabled by the 

user will be transmitted; all other output will be suppressed 
locally by the Interface. Each record consists of a one- 
byte field specifying the output class, a one-byte output- 
class-dependent field, a variable-length data field, and a 
two-byte field containing the combined length in bits 
(unsigned) of the data and output-class-dependent fields. 
Each record has the following form: 


The integer above each field is the length of that field 

in bytes (except where stated to the contrary). The length 
of a record, then, is given in bits by the contents of the 
length field plus twenty-four. The significance of the 
data and class-dependent fields, and the output class 
assignments are given in the following sections for each 
output class. 


A. ALPHAMERIC OUTPUT (CLASS 1) 


For alphameric output, the output class fieid contains 
the following: 


Bits 0-3: unpredictable 
Bits 4-7: 0001 


The contents of the class-dependent field are unpredictable. 
The data field contains the alphameric display in the form 
of a contiguous string of one-byte characters. Any char- 
acter listed in Figure 2 may be present. The list includes 
the Greek and Latin alphabets, a variety of special symbols, 
as well as carriage control characters such as carriage 
return, line feed, backspace, and erase. 

Alphameric output records embody system-generated 
messages, LIST mode displays, lower key-board activity on 
the TYPE level, TYPE level operators such as UP and DOWN, 
etc. The appearance of the character pair 'BACK ERASE! 
(x'59BC') in a record represents a command to erase the 
display scope. When not immediately followed by ERASE, 


BACK indicates a backspace operation. 'BREAK' (x'79') 
is used to facilitate formatting of long messages that may 
be either printer- or display-scope-destined. In generating 


scope display, where there are twenty-five characters per 
line, 'BREAK' should be interpreted as a carriage return; 


in generating printer output, where longer lines are possible, 


it should be interpreted as a space or blank.. 


FIGURE 2. 
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NAME Case 
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ALPHAMERIC OUTPUT CHARACTER SET 


NAME 


ALPHA 
BETA 
CHI 
DELTA 
EPSILON 


LAMBDA 
MU 

ETA 
OMICRON 


vu 
w 
WWIKDNEAWNHHO! 


Upper 
Case 


(cont'd) 


NAME 


PLUS + 
MINUS - 

SLASH / 
APOSTROPHE ' 
LOGICAL AND 4 
ASTERISK * 
EQUALS = . 
SEMI-COLON ; 
LEFT PAREN ( 
RIGHT PAREN ) 
COMMA , 

PERIOD . 
QUESTION MARK ? 
LOGICAL OR | 


Carriage 
Control 


BACK (backspace) 

RETURN (carriage 
return) 

TAB (advance to 
next tab) 

UP (line feed up) 

ENL (line feed up) 

DOWN (line feed 
down) 

CON (line feed 
down) 

RS (position to 
upper left of 
display area) 

ERASE 

BREAK (for display 
scope: RETURN 
for line 
printer: SPACE) 

SPACE (blank) 


NOTE: - 


NAME 


UNDERSCORE 

AT SIGN @ 

POUND SIGN # 
CENT SIGN ¢ 
DOLLAR SIGN $ 
PERCENT SIGN % 
COLON : 

LEFT BRACKET [ 
RIGHT BRACKET ] 
LESS THAN < 
GREATER THAN > 
QUOTE " 
LOGICAL NOT “> 
EXCLAMATION | 


Special List 
Mode Characters 


SPACE 

POST LIST 

DIVIDE $ 

MULTIPLY © 
SUBTRACT 9 

ADD @ 

CARRIAGE RETURN A 
DELETE ga 

POINTER _ 


Miscellaneous 


DOT (curvilinear 
display, 
dot-dot mode) 


Codes are specified in hexadecimal and are eight bits. 


'ss' means ‘superscript’ 


B. CURVILINEAR OUTPUT (CLASS 2) 


For curvilinear output, the output class field 
contains the following: 


Bits 0-1: 00 indicates line segment mode 
(adjacent display points are to 
be connected by straight lines): 

01 indicates dot mode 

10 indicates character mode (the 
class-dependent field contains a 
character from Figure 2 which is 
to be displayed at each point 
('dot-dot' mode is character mode 
with the display character 'DOT' 


P e (x'78')). : 
Bits 2-3: unpredictable 
Bits 4-7: 0010 


For character mode, the class-dependent field contains the 
display character; in other cases, the contents of that 
field are unpredictable. The data field contains a list 
of X-Y display coordinates as depicted below: 


X. and Y, are the x and Y display coordinates--after 
staling--of the i component of the vector represented by 

this record. Each coordinate is contained in a two-byte 

field, therefore one component in four bytes, and hence 

the context of the vector being displayed is given by the 
contents of the length field minus eight divided by thirty-two. 
The assumed display area is square, with origin at lower 

left, and both X and Y ranging between 0 and 4095. There 

is a one-to-one correspondence between vectors displayed 

and curvilinear output records transmitted. 


a 


C. SPECIAL CHARACTER OUTPUT (CLASS 3) 


For special character output, the output class field 
contains the following: 


Bits 0-3: unpredictable 
Bits 4-7: 0011 


The contents of the class-dependent field are unpredictable. 
The data field contains a contiguous string of variable- 
length characters, each representing either a move in one 
of sixteen directions or a change in position relative to 
the lower right corner of the last character frame (where 
for alphameric and special character display, the display 
area is square, 4096 units in extent vertically and horizon- 
tally, and a character frame is ló0units wide and 224 units 
high). 

The sixteen characters which define move operations 
are listed in Figure 3, and each is one byte long. Such a 
character indicates a move from the current position, in 
the specified direction, a distance equal to that 
of a move in the same direction from the center of a 
64-unit square to its perimeter. The length of the move 
is therefore functionally related to its direction. 

A change in position relative to the lower right 
corner of the last character frame is represented by a 
four-byte character of the form: 


1 12 bits 12 bits 


x'70! AX AY 


where A X and A Y are signed quantities indicating the 
number of units change along each coordinate. 


no 


FIGURE 3, SPECIAL CHARACTER VECTOR CHARACTER SET 


DIRECTION CODE 
000.0 47 
022.5 48 
045.0 51 
067.5 52 
090.0 53 
112.5 54 
135.0 55 
157.5 56 
180.0 57 
202.5 58 
225.0 41 
247.5 42 
270.0 43 
292.5 44 
315.0 45 
337.5 46 
NOTE: 


Codes are specified in hexadecimal and are eight bits. 


Directions are specified in degrees, increasing counter- 
clockwise from 0° at positive X in an X-Y coordinate system. 


